Sourced from com.squareup.okhttp3:okhttp's changelog.

Version 5.0.0-alpha.17

2025-06-29

This release stabilizes many APIs for the imminent OkHttp 5.0.0 release.

• New: TrailersSource, a public API for HTTP trailers. Production callers shouldn't need this as the API to read response trailers is unchanged. Testers may use this new stable API to supply trailers for a Response.

• New: Path.asRequestBody() is now a non-experimental API.

• New: FileDescriptor.toRequestBody() is now a non-experimental API.

• New: Stop using experimental coroutines APIs in our okhttp-coroutines artifact.

• Breaking: Move gzip from RequestBody to Request.Builder. This new API handles both compressing the request body and also adding the corresponding Content-Encoding header. Note that this function is sensitive to when it is called: the response body must be supplied before it can be compressed.

• Breaking: Remove AddressPolicy, AsyncDns, and ConnectionListener from the public API. We intend to ship a public API for these features, but we don't want to hold OkHttp 5.0.0 until those APIs are stable.

• Fix: Change MockWebServer.close() to cancel ongoing calls that are blocked on a delay.

• Upgrade: [Okio 3.13.0][okio_3_13_0].

This release also stabilizes many APIs in the mockwebserver3 artifact that's new in 5.0.

• Breaking: RecordedRequest.body is now nullable. Null is used when the request does not have a body.

• Breaking: RecordedRequest.chunkSizes is now nullable. Null is used when the request does not use chunked encoding. This is different from an empty list - that indicates the request is chunked but has no data.

• Breaking: Replace SocketPolicy with a new type, SocketEffect. It splits triggers (request start, response body, etc.) from effects (closing the socket, closing the stream, etc.).

• Breaking: Rename RecordedRequest.sequenceNumber to exchangeIndex and introduce connectionIndex on that type. These properties may be useful when testing features like connection reuse.

• Breaking: Replace our parameters-based JUnit 5 extension with a new annotation, @StartStop. Put this annotation on a MockWebServer property and the extension will start it before your test executes and stop it after it completes. No further configuration is required.

... (truncated)

• ae1145c Prepare for release 5.0.0-alpha.17.
• dba12fc Update dependency de.mannodermaus.gradle.plugins:android-junit5 to v1.13.1.0 ...
• dbefb80 Update testcontainers-java monorepo to v1.21.3 (#8893)
• b14aa25 Update com.squareup.okio to v3.14.0 (#8891)
• 9bb23fc Update kotlinx.serialization to v1.9.0 (#8889)
• 4a7f993 Update dependency net.ltgt.gradle:gradle-errorprone-plugin to v4.3.0 (#8888)
• 5365bd4 Update dependency com.google.devtools.ksp:symbol-processing-gradle-plugin to ...
• 5a37937 Update dependency org.jetbrains.kotlinx.binary-compatibility-validator:org.je...
• d6e9fb8 Update dependency com.android.tools.build:gradle to v8.11.0 (#8885)
• 931a762 Update junit.platform to v1.13.2 (#8881)
• Additional commits viewable in compare view

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot merge will merge this PR after your CI passes on it
• @dependabot squash and merge will squash and merge this PR after your CI passes on it
• @dependabot cancel merge will cancel a previously requested merge and block automerging
• @dependabot reopen will reopen this PR if it is closed
• @dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
• @dependabot show <dependency name> ignore conditions will show all of the ignore conditions of the specified dependency
• @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)